Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrStlInit

QuickDraw GX sends the GXPrStlInit message when an application that supports the Macintosh Printing Manager calls the PrStlInit function to add controls to the style dialog box that is displayed when the PrDlgMain function is called. You can override the GXPrStlInit message to customize the handling of the PrStlInit function. Your override of the GXPrStlInit message must match the following formal declaration:

OSErr MyPrStlInit (THPrint aTHPrint, TPPrDlg *aTPPrDlg);

aTHPrint

A handle to the print record for this printing operation.

aTPPrDlg

A pointer to the dialog structure for the style dialog box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrStlInit message sets up default controls in the style dialog box. You can override this message if you need to add any special handling to the processing of PrStlInit calls by your printer driver.

SPECIAL CONSIDERATIONS

You never send the GXPrStlInit message yourself.

You almost always forward the GXPrStlInit message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrStlInit function is described in Inside Macintosh: Imaging With QuickDraw.

The dialog control and customization resources are described in the chapter "Printing Resources" in this book.

The dialog and item list resources are described in Inside Macintosh: Macintosh Toolbox Essentials.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help